// 版权所有2009 Go作者。保留所有权利。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// go:build aix | | darwin | | | dragonfly | | freebsd | | | | | | | | | | | | | | js wasm | | | | linux | | netbsd | | | | | | openbsd | 124。中断（向进程发送中断）和操作系统。Kill（强制

package os

import (
	"internal/itoa"
	"internal/syscall/execenv"
	"runtime"
	"syscall"
)

// 进程退出）。在Windows上，发送操作系统。使用
// os中断进程。过程信号未执行；它将返回错误，而不是
// 发送信号。
var (
	Interrupt Signal = syscall.SIGINT
	Kill      Signal = syscall.SIGKILL
)

func startProcess(name string, argv []string, attr *ProcAttr) (p *Process, err error) {
	// 如果没有sysprocatr（即没有Chroot或更改的
	// UID/GID），请仔细检查我们希望
	// 进入的目录是否存在。我们可以通过这种方式使错误更清楚。
	if attr != nil && attr.Sys == nil && attr.Dir != "" {
		if _, err := Stat(attr.Dir); err != nil {
			pe := err.(*PathError)
			pe.Op = "chdir"
			return nil, pe
		}
	}

	sysattr := &syscall.ProcAttr{
		Dir: attr.Dir,
		Env: attr.Env,
		Sys: attr.Sys,
	}
	if sysattr.Env == nil {
		sysattr.Env, err = execenv.Default(sysattr.Sys)
		if err != nil {
			return nil, err
		}
	}
	sysattr.Files = make([]uintptr, 0, len(attr.Files))
	for _, f := range attr.Files {
		sysattr.Files = append(sysattr.Files, f.Fd())
	}

	pid, h, e := syscall.StartProcess(name, argv, sysattr)

	// 确保我们没有运行attr的终结器。文件夹。
	runtime.KeepAlive(attr)

	if e != nil {
		return nil, &PathError{Op: "fork/exec", Path: name, Err: e}
	}

	return newProcess(pid, h), nil
}

func (p *Process) kill() error {
	return p.Signal(Kill)
}

// ProcessState存储Wait报告的有关进程的信息。
type ProcessState struct {
	pid    int                // 进程的id.
	status syscall.WaitStatus // 依赖于系统的状态信息。
	rusage *syscall.Rusage
}

// Pid返回已退出进程的进程id。
func (p *ProcessState) Pid() int {
	return p.pid
}

func (p *ProcessState) exited() bool {
	return p.status.Exited()
}

func (p *ProcessState) success() bool {
	return p.status.ExitStatus() == 0
}

func (p *ProcessState) sys() any {
	return p.status
}

func (p *ProcessState) sysUsage() any {
	return p.rusage
}

func (p *ProcessState) String() string {
	if p == nil {
		return "<nil>"
	}
	status := p.Sys().(syscall.WaitStatus)
	res := ""
	switch {
	case status.Exited():
		code := status.ExitStatus()
		if runtime.GOOS == "windows" && uint(code) >= 1<<16 { // windows使用大十六进制数
			res = "exit status " + uitox(uint(code))
		} else { // unix系统使用小十进制整数
			res = "exit status " + itoa.Itoa(code) // unix 
		}
	case status.Signaled():
		res = "signal: " + status.Signal().String()
	case status.Stopped():
		res = "stop signal: " + status.StopSignal().String()
		if status.StopSignal() == syscall.SIGTRAP && status.TrapCause() != 0 {
			res += " (trap " + itoa.Itoa(status.TrapCause()) + ")"
		}
	case status.Continued():
		res = "continued"
	}
	if status.CoreDump() {
		res += " (core dumped)"
	}
	return res
}

// ExitCode返回已退出进程的退出代码，或-1 
// 如果进程尚未退出或被信号终止。
func (p *ProcessState) ExitCode() int {
	// 如果进程尚未启动，则返回-1。
	if p == nil {
		return -1
	}
	return p.status.ExitStatus()
}
